home *** CD-ROM | disk | FTP | other *** search
/ Utilities Professional 1-1500 / Utilities Professional 1-1500 (1994)(WPD)[!].iso / 12511500 / var1292.dms / var1292.adf / chasym / palette.doc < prev    next >
Text File  |  1993-03-16  |  7KB  |  164 lines
  1.  
  2.        ************************************************************* 
  3.                    Gumby's Palette Tool (C) 1991 V1.1
  4.        *************************************************************
  5.  
  6.      Programmed by Andrew Kreibich with AMOS (C) 1990 Mandarin/Jawx.
  7.  
  8.    
  9.  
  10.      INSTRUCTIONS:
  11.      ************ 
  12.  
  13.      This procedure currently supports the following features.
  14.  
  15.      DRAGBAR:
  16.      This is the message (Gumby's Palette) at the top of the screen. 
  17.      Hold left mouse button down while you are over this and drag the
  18.      palette screen up and down your screen.
  19.  
  20.      ABOUT:
  21.      Work this out for yourself!
  22.  
  23.      RGB sliders: These work in the usual way, just click on the slider
  24.      with the left mouse button and drag it along, or just click on the
  25.      spot you want it to go to.
  26.  
  27.      Up to 32 colours are displayed in little boxes on the right of the    
  28.      screen. You can select two of these at any time. If the screen is
  29.      EHB then the lower half of each box shows the extra half bright
  30.      colour.
  31.      Left mouse button selects the CURRENT colour. This will be changed
  32.      by moving the slider bars.
  33.  
  34.      Right mouse button selects the TO colour. This is used by COPY,
  35.      SPREAD and CYCLE, to copy, spread or cycle from the current colour    
  36.      to the TO colour, and also by SWAP to swap the current colour with   
  37.      the TO colour.
  38.  
  39.      The TO and CURRENT colours are outlined in different colours so that
  40.      you can see them. It is possible that the colours used by these 
  41.      outlines are impossible to see because they are the same or similar
  42.      to the colour YOUR programme uses in register 18. This is used by the 
  43.      procedure to draw the background around the colour boxes. If this is
  44.      the case you can fix this by changing GPBGCOL1 to some other number at 
  45.      the start of the procedure.
  46.      Similarly the background colour of the lower boxes can be changed
  47.      by changing GPBGCOL2 to some other number if you are having trouble
  48.      seeing the buttons.
  49.  
  50.      COLOUR Buttons:
  51.      There are 6 of these, GET, COPY, SWAP, CYCLE, SPREAD and SKIP.
  52.      These are selected with the left (and sometimes right) mouse button.
  53.  
  54.      COPY and SWAP are explained above.
  55.  
  56.      CYCLE. Press Left mouse button to cycle forward and right mouse 
  57.      button to cycle backwards.
  58.  
  59.      SPREAD spreads the colour from the current colour to the TO colour
  60.      and works in conjunction with the SKIP button. 
  61.  
  62.      If SKIP is 1 then the spread will skip 1 colour in between each      
  63.      one it spreads. Best way is to try it! I put this in because I 
  64.      thought it might be useful in a Mandelbrot type programme.
  65.      SKIP can be any number you like providing it is between 0 and 9.
  66.      I don't think it would be a very good idea to set it to a number   
  67.      greater than the number of colours between the two colours you are
  68.      spreading between. This could cause some unpredictable results.
  69.      Usually you will leave this set to zero.
  70.    
  71.      GET brings up a window with a number of preset colours.
  72.          You can pick any colour to be changed into one of the preset 
  73.          colours. Pick your CURRENT GET colour by clicking it with the
  74.          Left mouse button. This will not disturb your CURRENT and TO
  75.          settings although the outlines on these boxes may disappear
  76.          while the get window is open. (They will return when you close
  77.          this window.)
  78.          When you open this window the CURRENT GET colour will be set to 
  79.          colour number 2 (third from the left on the top row). If you don't
  80.          want to change this colour then select a different one.     
  81.  
  82.          The up and down arrows on the left move the list of colours up 
  83.          and down.
  84.      
  85.          P picks the colour in the middle of the box and changes your CURRENT
  86.          GET colour to this. 
  87.      
  88.          R assigns a random colour to your CURRENT GET colour.
  89.  
  90.          Cancel CURRENT returns your CURRENT GET colour to what it was
  91.          before you opened the GET window.
  92.          Cancel ALL returns all of the colours to what they were before
  93.          you opened the GET window. 
  94.  
  95.          QUIT quits the GET window.
  96.  
  97.          If you wish to add preset colours you can do so by adding more  
  98.          DATA statements at the start of the programme. 
  99.          These take the form:-
  100.  
  101.              DATA colourname,$RGB
  102.  
  103.          The only restrictions on these are.
  104.              (a) colourname must be <= 14 characters including spaces
  105.              (b) you  must set GPGTNUM to 1 less that the number of colours
  106.              that you wish GET to use.
  107.              (c) $RGB is the RGB value for the colour in hex. Don't forget 
  108.              the $. 
  109.  
  110.  
  111.      PALLETE BUTTONS. There are three of these in V1.1 
  112.      They are SPR, ICON, and DEF.  (ICON is new in v1.1)
  113.  
  114.      SPR performs a Get Sprite Palette when you click it.
  115.      The procedure checks to see if there is anything in the sprite
  116.      bank (bank 1) and if you have no sprites then this button will be 
  117.      inactive.
  118.  
  119.      ICON performs a Get Icon Palette when you click it.
  120.      The procedure checks to see if there is anything in the icon bank
  121.      (bank 2) and will render this button inactive if the bank is empty.
  122.  
  123.      DEF Left mouse 
  124.      returns all colours to your programme's default colours
  125.      providing you have loaded them into the array GPDEFPAL and you
  126.      have set DEFFLAG to 1 (see VERY IMPORTANT below).
  127.  
  128.      DEF Right mouse
  129.      selects the AMOS default palette unless you have previously     
  130.      used the AMOS 'DEFAULT PALETTE ' command in your programme,in which 
  131.      case it will use these values instead.
  132.      If GPDEFFLAG=0 then clicking DEFAULT with the left mouse button 
  133.      will give you the same result as DEFAULT Right mouse button.
  134.      Naturally, if you are silly enough to set GPDEFFLAG to 1 without 
  135.      filling the GPDEFPAL array first then all colours will be set to
  136.      ZERO, and you will not see very much! PROGRAMMERS BEWARE! 
  137.      
  138.      Exit CANCEL cancels all changes and returns you to your programme.
  139.      Exit ACCEPT keeps all changes and returns you to your programme.
  140.  
  141.       
  142.  
  143.  
  144.       ############
  145.           BUGS
  146.       ############
  147.  
  148.       My software does not contain bugs! It has been thoroughly tested and
  149.       it works! It does however contain one slightly undesirable feature
  150.       (an extra outline box over the right side of the slider bars)      
  151.       which pops up from time to time when you change colour boxes. It will
  152.       quickly disappear when you chose another box or two and does not 
  153.       seem to affect the running of the programme. You will probably not even
  154.       notice it. I have been unable to track down the cause of this because
  155.       it happens so rarely. If you can give me any feedback on when this
  156.       happens, its cause, or even better, a fix, I will be grateful.
  157.  
  158.       If you do happen to find any other undesirable features let me know.
  159.  
  160.  
  161.  
  162.     Regards,
  163.     Andrew.
  164.